---
title: "Invoice update"
method: POST
path: "/{base URL}"
---

# Invoice update

`POST /{base URL}`

## Path parameters

- `base URL` 'tsp/pg/portal/pay/paymentInvoiceService', required

## Request body

- object
  - `merchantId ` string, required — Merchant account ID. SIze-12
  - `aggregatorId` string — Aggregator account ID. Required if request is initiated from aggregator. SIze-12
  - `userID` string — Unique Identifier of the user. If sent it should be the same as sent in the original request. SIze-24
  - `invoiceNo` string, required — Unique Ref/Invoice number for the payment request. Should be the same as sent in original request. SIze-32
  - `invoiceStatus` string, required — C – Close/Cancel P – Paid O – Open ERP system can send update to either close/cancel an invoice. If the invoice is paid by any other channel then the same can be updated by using status as Paid. Close – Can be used only when the invoice is fully open (not fully or partly paid). For updating the dueDate/additionalFee send invoiceStatus as O. This status cannot be used to reopen a Paid/Closed/Cancelled /Refunded invoice. SIze-1
  - `desc` string — Description / remarks. SIze-48
  - `dueDate` string — Due Date. DD/MM/YYYY Can be changed only before the dueDate. SIze-10
  - `additionalFee` number — Additional fee that need to be charged. Can be used to charge penalty/late fees
  - `secureHash` string, required — Hash value. SIze-64

## Response `200`

- object
  - `responseCode` string, required — Response code indicating success/failure 0000 – Success, Any other value failure Size- 4
  - `respDescription` string, required — Description of failure. Ignore for success response. Size- 45
  - `merchantId` string — Merchant account ID. Echo of request field
  - `aggregagtorId` string — Aggregator account ID. Echo of request field
  - `invoiceNo` string — Merchant Txn ref Number. Echo of request field
  - `userID` string — Echo of request field
  - `txnID` string — The unique ref number generated by the PG. Size- 24
  - `secureHash` string, required — Hash value. Size- 64

---

[API](https://skmtc.net/jiopay/apis/jiopay-pg.md) · [All operations](https://skmtc.net/jiopay/apis/jiopay-pg/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jiopay/jiopay-pg/versions/55aa41b8482f/schema)